Indigo ReadMe

Indigo Home Control Server

version 1.5.5
14 December 2004

Welcome to Indigo Home Control Server! To install Indigo, simply drag the Indigo application on to your Applications folder.

The Indigo manual is available via the built-in Indigo help book (choose the Indigo->Indigo Help menu item from within Indigo) and via the included User Manual PDF. The built-in help book is ideal for quickly looking up help topics from within Indigo, while the PDF can be printed. To view the PDF, we recommend using the latest version of Adobe Acrobat Reader.

Be sure and read the Getting Started section of the manual to get your home control system up and running quickly. Visit our website for valuable support resources. For answers to frequently asked questions, visit:

  http://www.perceptiveautomation.com/indigo/faq.html

Join the online support forum for home automation discussions, software questions, and tips:

  http://www.perceptiveautomation.com/indigo/forum.html

Visit the Indigo Script Library to download the latest AppleScripts for extending Indigo:

  http://www.perceptiveautomation.com/indigo/scripts.php

Or visit the main support page for a complete list of our support resources:

  http://www.perceptiveautomation.com/indigo/support.html

Important Notes

PowerLinc USB users should plug the PowerLinc USB directly into one of their computer's USB ports. The PowerLinc USB powers itself from the USB hub itself, and may not work correctly when plugged into a keyboard, monitor, or some external USB hubs.

Indigo requires OS X 10.2.6 or higher. Earlier versions of OS X will likely work if you are not using the PowerLinc USB inteface, but are no longer officially supported.

The email scanning and sending capabilities of Indigo are compatible with SMTP and POP3 servers. Indigo will not connect to IMAP servers, and can not send email through SMTP servers that require authentication. For more information on configuring Indigo, see the Getting Started section of the Indigo help book.

Version History

Changes included in 1.5.5:

Fixed bug that caused the PowerLinc Controller (1132CU) to freeze when Indigo was trying to upload the sunset/sunrise data. This freeze would then cause Indigo to freeze until the PowerLinc cable was disconnected from the computer. If you experienced this problem, then before you try to run Indigo 1.5.5 you must: unplug the PowerLinc (from outlet and Mac), press the reset button, plug it back in, release the reset button, and reboot your computer.
Fixed bug that caused problems accessing some Time/Date Actions from AppleScript.
Fixed bug that caused some AppleScript commands to fail when setting properties to an empty string.

Changes included in 1.5.4:

Added AppleScript verbs send x10 status response on and send x10 status response off so Indigo can respond to status request messages.

Changes included in 1.5.3:

Updated RCS attachment, templinc attachment, and time stamp attachment scripts to avoid random device code extraction error. Changes to RCS attachment script to correctly update Indigo variables on thermostat change broadcasts. Note that the RCS script functions no longer have a variable argument -- see comments in scripts for more information.

Changes included in 1.5.2:

Added PowerLinc Controller (1132CU) upload support for auto-on, auto-off, and delayed actions.
Added AppleScript application properties latitude and longitude.
Improved PowerLinc Controller (1132CU) upload support for Set Brightness actions.
Improved AppleScript error reporting for all verbs and objects. In general, error messages will now be more verbose and useful.
Increased the number of dim/brightens (generic, not preset or extended) sent by the 1132CU to improve relative dimming accuracy.
Fixed bug that caused Time/Date Actions to not be deleted if the delete action is nested within another Time/Date Action that is currently being processed.
Slight X10 interface timing modification to hopefully prevent known X10 RF transceiver bug that causes the transceiver to retransmit the previous X10 command, resulting in a loop.
Updated Device UI for SwitchLinc PLC module to accurately reflect that module's capabilities.

Changes included in 1.5.1:

Added support to upload Trigger and Time/Date Actions to PowerLinc Controller (1132CU). Now you can have basic home control without leaving your Mac running 24/7.
Added shortcut key navigation (cursor keys) of all list views.
Added AppleScript classes time date action and trigger action.
Added RF handling to prevent DM10A RoboDog commands from being reported as undefined signals.
Improved communication performance between Indigo and PowerLinc USB.
Improved reliability of establishing connections with the CM-11 interface.
Fixed AppleScript terminology conflict between device property type and action step property action type. AppleScripts that use the device property type may need to be recompiled.
Fixed bug that sometimes caused received status response commands to be repeated several times, resulting in multiple Trigger Actions for a single response.
Fixed bug that caused Time/Date Actions to not trigger at the correct time after daylight savings time spring-forward.
Fixed bug that caused the device brightness state to be incorrect when Trigger Actions try to modify the brightness of the same device that caused the trigger.
Fixed bug that allowed scripts to create variable names that contain spaces.

Changes included in 1.3.3:

Added support for the new PowerLinc USB Controller interface. Indigo currently only supports using this interface in an online mode with Indigo running. Indigo will not yet upload schedules or logic to the controller.
Really fixed bug that sometimes caused an Indigo crash when connection attempt to an interface fails. Previous fix in 1.3.2 did not always prevent the crash.

Changes included in 1.3.2:

Added RCS attachment and RCS example scripts to provide AppleScript support of RCS 2-way thermostats.
Added AppleScript application properties database file and script files.
Added AppleScript verb execute script to execute files returned by the script files application property.
Added LampLinc Essential device type.
Fixed incompatibility that caused email scanning to fail on some POP servers.
Fixed bug that sometimes caused an Indigo crash when updating Indigo variable values via AppleScript.
Fixed bug that sometimes caused an Indigo crash when connection attempt to an interface fails.
Replaced application and document icons.

Changes included in 1.3.1:

Fixed bug that sometimes caused an Indigo crash when updating Indigo Variable values via AppleScript, when the resulting value change triggered another AppleScript action.

Changes included in 1.3.0:

Added support for the Ovolab Phink telephony device. This allows remote control of Devices and execution of Action Groups over telephones using a dynamic menu-driven system. Inside Indigo, use the “Display in remote UI” checkbox in the Device dialog and Action Group dialog to control which items are spoken over the voice synthesized menu.
Added support for floating point Variable triggers and conditionals.
Added AppleScript verb remove delayed actions for easily deleting delayed, auto-on, auto-off, auto-enable, and auto-disable actions.
Added AppleScript verbs send x10 dim and send x10 brighten to send dim and brighten commands directly to a specific X10 address.
Added templinc attachment script to provide easy AppleScript support of TempLinc devices.
Added support for DS10A door/window security sensor.
Updated X10 code sequence used to lock in on/off ramp rate for all SwitchLinc and LampLinc modules (new sequence: O16 P16 N16 M16 O16). The previous sequence did not work on all devices.
Fixed bug that caused Indigo to incorrectly update device states when receiving X10 commands from multiple house codes almost simultaneously.
Fixed bug that caused help to fail to open external URLs under OS X 10.3.
Fixed bug that caused calling some AppleScript verbs without optional parameters to signal an error.

Changes included in 1.2.3:

Added auto-on UI option for the Turn Off device action type.
Added ApplianceLinc 2-Way, ApplianceLinc PLC, and LampLinc PLC device types.
Added scenes attachment script which allows you to easily create lighting scenes for scene enabled SwitchLinc, LampLinc, and ApplianceLinc modules.
Added device target attachment and group target attachment scripts which allow sequential targeting and control of Devices and Action Groups from AppleScript. If you have already run a previous version of Indigo and want to use these attachments, then you will need to manually copy the attachment file out of the Indigo package:
Indigo/Contents/Resources/First Run/Scripts/Attachments
into the folder:
~/Documents/Indigo User Data/Scripts/Attachments
Added AppleScript verbs send x10 hail ack and send x10 hail request to send hail commands directly to a specific X10 address.
Improved UI layout for OS X 10.3.
Improved communication performance between Indigo and PowerLinc USB.
Fixed bug that caused randomized Time/Date Actions to sometimes be scheduled multiple times in one day.

Changes included in 1.2.2:

Added time stamp attachment script. This adds two Applescript functions, GetTimeStampForAddress() and GetTimeStampForDevice(), for retrieving the last Date/Time that an X10 command was received for a particular address or device.
Fixed bug in Device dialog that caused the “Display in remote UI” checkbox to remain checked even if the selected device type does not support On/Off commands, such as remote controls.
Updated registration library.

Changes included in 1.2.1:

Updated X10 code sequences used to download “Default on dim level” and on/off ramp rate to all SwitchLinc and LampLinc modules. Indigo now uses the newer code sequences recommended by SmartHome.

Changes included in 1.2.0:

Added support for PowerLinc 1132U (USB) interface. Indigo no longer requires a USB to serial adapter for the main X10 interface!
Improved reliability of sending and receiving extended commands to the PowerLinc 1132A (Serial) interface.
Improved reliability of establishing connections with the CM-11 interface.
Modified how Indigo communicates preset dim commands to the LynX-PLC interface for improved reliability.
Fixed incompatibility that caused email scanning to incorrectly report empty 'subject' and 'from' fields when scanning messages on some POP servers.
Fixed incompatibility that caused email scanning to fail when Indigo connected to some POP servers that had no messages.
Changed formatting of saved log files to a more verbose tab delimited format which is easier to parse or import into other applications. The log window itself displays using the new format, but still batches timestamps together for readability.
The AppleScript verb log has been modified. The arguments no linefeed and no timestamp are deprecated, and a new argument using type has been added.
Added Interface menu option to clear the CM11 macro and timer memory.
Modified delayed Time/Date Actions to automatically be saved on quit.
Fixed incorrect font usage on some UI controls.

Changes included in 1.1.1:

Increased email send and receive timeout from 10 seconds to 60 seconds.
Fixed attachment script loading bug that caused crash during Indigo launch on some systems.

Changes included in 1.1.0:

Added support for the Salling Clicker application. This allows remote control of Devices and execution of Action Groups using a Bluetooth enabled Sony Ericsson phone and the Salling Clicker application. Inside Indigo, use the “Display in remote UI” checkbox in the Device dialog and Action Group dialog to control which items are displayed on the phone menu.
Added support for the W800RF32 RF receiving interface.
Major enhancements to the attachment script plug-in architecture. In general, attachment scripts should now be saved as “Compiled Scripts” and not as applications. Indigo will automatically load all attachment scripts at application launch, and all handlers (subroutines) in attachment scripts can be directly called from within Indigo AppleScript actions. Conversely, attachment scripts can now directly call back into Indigo. All Indigo specific events are first dispatched to attachment scripts before being dispatched to Indigo. This allows you to create scripts that augment or override Indigo's default functionality.
The iTunes attachment script that allows remote control of iTunes using the “X10 Entertainment Anywhere” remotes was rewritten to use the new plug-in architecture. Because this new attachment script is now a compiled script and not an application, you will no longer see the iTunes attachment application in the Finder Dock.
Added AppleScript verbs send x10 on and send x10 off to send on and off commands directly to a specific X10 address.
Added AppleScript verb send status request to send a status request command directly to a specific X10 address.
Added AppleScript verb execute group to directly execute all actions in a named action group.
Added several AppleScript properties to device object: display in remote ui, last changed, supports on off, and supports dimming.
Added AppleScript property to action group object: display in remote ui.
Added AppleScript attachment handler: on receive security event.
General UI cleanup. Clutter reduced in some dialogs.

Changes included in 1.0.1:

Fixed bug that caused non-dimming devices to not update their status correctly in the main window. In some cases this bug caused looping exception errors.